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APPENDIX A 
DATA INPUT FORMS 


The following pages contain input forms which may be used to prepare 

~ /*|2fc C\ I /<• 

data for the S0UP5V3.4 version of the R2BCSAT-83 data base/ The contents of 


the fields on these forms were discussed in detail in Chapter 3 of this manual 
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APPENDIX B 

INSTALLATION AND CHECKOUT PROCEDURES 
FOR THE SOUP5 SYSTEM 


This appendix describes the IBM job control language which can be 
used to run the S0UP5 system from a magnetic tape/ Of course, many possible 
runtime sequences are possible. 

The S0UP5 System is delivered in the form of a magnetic tape 
containing source code and data files and a card deck to run the system from 
the tape. The card deck is written in IBM 360/370 OS/MVS job control language 
(JCL) and must be rewritten in the language of the operating system of the 
computer on which it is to be installed. A listing of the card deck is 
attached as Table B-l. It performs the following steps: 

1. Reads and copies the program source data card-image data files 


from 

tape 

to temporary disk files 

a. 

PI 

d. 

DATA. PI 

b. 

P2 

e. 

DATA. SCENARIO 

c. 

P3 

f. 

DATA .PARAMS 


2. Compiles and loads each of the three programs, generating 

temporary load modules for each program, as well as compiler 
source listings and maps and a loader cross-reference map. 


B-l 


3. Runs in sequence PI, P2, and P3, using the three temporary data 
files generated in step 1 and the DATA. CONTROL provided on cards 
in the JCL decks, for the TEST0008 scenario in DATA. SCENARIO. 

The printed outputs this run are sent directly to the system 
printer, using 133 characters per line output with column 1 of 
each line controlling printer output spacing and page breaks, in 
accordance with. the standard FORTRAN conventions. 

Appendix C contains a copy of the output as run on an IBM-370 system, 
using the same tape as delivered. 

The results of a run on any computer system should be almost 
identical to those in Appendix C. The possible exceptions are listed below: 

1. The format and contents of the programs' compi ler/ loader source 
listings, maps, and cross references. No warning or fatal 
errors may occur. 

2. The least significant digits in the outputs of P2 and P3 may 
vary due to machine precision differences. These must be 
resolved through numerical analysis. 

The user may change input/output unit numbers (from the ones documented in 
Figure 1) by changing the first card of DATA. PI, DATA.P2, DATA.P3 for Program 
1, 2 and 3 respectively. These files are documented in Chapter 3. 
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APPENDIX C 

RESULTS OF JOB USING EXAMPLE JCL 


The'-fo'Mowing-pages-eont-ain' copies of a run using the delivered tape 
and IBM OS/MVS Job Control Language card deck. A-fi-t- <2 N*o CiJtiJ 

It includes source program compilation listings, load maps, and the 
results of the TEST0008 scenario run by the deck: 


C-l 


Source program listings and load maps are not 
included in the User's Manual. They may be 
found in the Programmer's Manual. 
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APPENDIX D 

NUMERICAL LIMITS ON SCENARIO DATA REQUESTS /wu*. 


The S0UP5 system has some limits on the maximum number of tables 
which can be included in each scenario. These numbers were chosen to be large 
enough to accommodate almost every conceivable scenario. The limits below are 
incorporated in S0UP5 Version 3 Mod 8 (S0UP5V3.8). They can be changed at 
each installation if desired. See Appendix B of the Programmer's Manual. The 
current values at each installation can be found on lines 5-25 of DATA. PI. 


LIMIT VALUE 

Number of Service Areas 300 
Number of feeder link transmitters 2400 
Number of earth station receivers 2400 
Number of point overrides 500 
Number of points in one point set 50 
Number of scenario description lines 10 
Number of channelizations for up 15 
Number of channelizations for down 15 
Number of channel families for up 40 
Number of channel families for down 40 
Number of protection ratio templates up, down, and total 3 
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LIMIT 


VALUE 


Number of ellipses, up and down 360 
Number of antennas up and down 160 
Number of Gain tables up and down 60 
Number of Gain entries up and down 1500 


0-2 


APPENDIX E 

ERROR HANDLING, ERROR MESSAGES AND EDITING P iloctDvtflfc* 

frlrZ 0 H i ffl? 


An important function of S0UP5 is editing the data for errors and 
inconsistences. 

When Program 1 detects an error, it takes the following steps: 

• Prints an error message describing the error in the input echo 
report (Unit IURPT) 

• Assigns an error severity code; the codes are described below: 

-20 Minor error, no effect 

-21 Minor error, no probable effect 

-22 Results may be affected but calculations can continue 
-97 Part 1 and Part 2 may continue, but Part 3 cannot 
process 

-98 Part 1 may continue, but Part 2 cannot process 
-99 Part 1 cannot continue. 

• Stores the value of the highest error code encountered. 

• If the highest error code is greater than or equal to the stop 
code, (Columns 1-2 of 1st control record), the program stops 
with a stop code of 99. 


E-l 


• If the stop code is greater than the highest error code, 
processing continues whenever possible 

• At the end of the input echo report (on unit IURPT), the program 
prints a count of the total errors, and the errors listed by 
error severity code level. An example of the list is reproduced 
below. 


TOTAL NUMBER OF ERRORS = O 

ERRORS BY ERROR LEVEL 
LEVEL = 20 COUNT = 0 

LEVEL = 21 COUNT = 0 

LEVEL = 22 COUNT = O 

LEVEL = O COUNT = O 

LEVEL = 0 COUNT = O 

LEVEL = 0 COUNT = 0 

LEVEL = O COUNT = O 

LEVEL = 97 COUNT = O 

LEVEL = 98 COUNT = O 

LEVEL = 99 COUNT = O 


• At the end of the run, the program terminates with a stop code 
equal to the highest error code encountered. 


Program 2 handles errors in a similar fashion except that the error 
messages, documented in section 4.2.2 are written on unit IERUNT. 


PROGRAM 1 ERROR MESSAGES 


Program 1 produces a variety of error messages. Each message with 
its severity level is listed below, with further explanation if necessary. An 
error level greater than the stop code ( ISTOP ) in DATA. CONTROL will cause the 
program to stop. 

ERROR NUMBER ERROR MESSAGE ERROR LEVEL 


1 

PI control data not found 

99 

2 

Error reading PI control data 
- the record does not match the 
FORTRAN format 

99 
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ERROR NUMBER 


ERROR MESSAGE 


ERROR LEVEL 


3 

4 


5 


6 


7 


8 


9 


10 


Premature end of file in control data 99 

Error reading control data for P2-P5 99 

- one of the records does not match 
FORTRAN format 

Requested scenario not found in 99 

scenario file 

- check for misspelled scenario in control 
file 

Error reading scenario file 99 

- a record in the scenario file does not 
match its FORTRAN format 

Scenario file is out of sort 21 

- The numbers in the card type field or 
subcard field are not the correct sequence 

Premature end of scenario file 99 

- Check that number of service areas 
(cols 65-67 of Record 3 in Data. Scenario) 
is not greater than number of service areas 
in scenario. 

Out of space in array LKEY 99 

- the array designed to hold all the unique 
requested keys for antennas, point sets, 
beams, protection ratios, service areas, 
channel families, and gain tables is filled 

Out of space in tree arrays 99 

- the arrays designed to hold all tree data 
(see error 9 above) is filled 
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ERROR NUMBER 

ERROR MESSAGE 

ERROR LEVEL 

11 

Too many description lines truncating to max 
See Appendix D 

20 

12 

To many service areas truncating to max. 

98 


See Appendix D 


13 

Too many channelizations 

99 


- number of channelizations exceeds maximum. 
See Appendix D 

14 

Channelization file is out of sort 
- Channelization should be sorted of 1st 4 
bytes, character ascending 

21 

15 

End of Chzth data while searching for key 
- a non-existent channelization was 
requested - possible misspelling 

a 97 

16 

Channelization key not in Chztn data 
- check for misspelling (note: 
channelization key is character, not 
numeric. "01" is not the same as 
" 1"). 

97 

17 

Premature end of parameter file 

99 

18 

Error reading parameter file 

- record does not match FORTRAN format 

99 

19 

Too many channel families 

99 


- number of requested channel families 
exceeds maximum. See Appendix A 
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ERROR NUMBER 

ERROR MESSAGE ERROR LEVEL 

20 

Channel family key not in Chztn data 
- check for misspelling (note: 
channelization key is character, not 
numeric. "01" is not the same as 

II ^l» 

98 

21 

Too many channels in channel table 
- number of channel exceed maximum. 
See Appendix D 

99 


Using Down/Up Chztn for up/down paths 
- a channelization flagged as UP is 
being used for down path or vice versa 

22 

23 

End of RARC Param data while searching 
for key 

- cannot find key, check for misspelling 

97 

24 

Protection ratio set key not in data 

- cannot find key, check for misspelling 

97 

25 

Too many protection ratio template sets 
- number of protection ratio templates 
exceeds maximum allowed. See Appendix D 

99 

26 

End of Prot Ratio data while searching for key 
- cannot find protection ratio key, check 
for misspelling 

97 

27 

RARC param data out of sort 
- See Note C 

21 

28 

Not all beams found 

- A non-existent beam requested. Check for 
misspelling 

97 
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ERROR NUMBER 


ERROR MESSAGE 


ERROR LEVEL 


29 End of beam data while searching for key 97 

- A non-existent beam requested, check for 
misspelling 

30 Point set file out of sort 21 

- See Point set section of 3.3.2 for sorting 
sequence 

31 Point set key not in point set data 97 

- check for misspelling 

32 Too many points in point table 99 

- number of points in table exceeds maximum. 

See Appendix D 

33 End of point set data while searching for key 97 

- cannot find requested key. Check for misspelling 

34 98 

35 Too many points in a point set 99 

- number of points in set exceeds maximum. 

See Appendix D 

36 Gain table file out of sort 21/99 

- Gain tables should be sorted on first 
4 bytes, character ascending 

37 Gain table key not in gain table data 97 

- request for a non-existent key 
check for misspellings 

38 Illegal gain pattern type 97 

Pattern must be 1 to 15 
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ERROR NUMBER 


ERROR MESSAGE 


ERROR LEVEL 


39 


40 


41 


42 


43 


44 


45 


46 


47 


Too many gain tables 99 

- number of requested gain tables exceeds 
maximum. See Appendix D 

End of gain table data while searching for key 97 

- request for a non-existent gain table 

Too many beams 99 

- number of requested beams exceeds maximum. 

See Appendix D 

End of antenna data while searching for key 97 

- request for a non-existent antenna, check 
misspellings 

Too many antennas 99 

- number of requested antennas exceeds maximum 
See Appendix D 

Not all antennas found 98 

- request for a non-existent antenna, check 
for misspellings 

Too many gain table entries 99 

- gain table entry table exceeds maximum size. 

See Appendix D 

Not all gain tables found 22 

- request for a non-existent gain table 

Not all channel families found 98 

- request for a non-existent channel family 
(see error 20) 
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ERROR NUMBER ERROR MESSAGE ERROR LEVEL 

48 Not all protection ratios found 21 

- request for a non-existent protection ratio 
set. Check for misspellings 

49 Too many point overrides 99 

- number of point overrides exceeds maximum. 

See Appendix D 

50 No diameter or cov ang specified for 97 

E-ant. Earth antenna has a diameter/ 
coverage angle < 0. 

51 Diameter or Cov. Ang specified for S-ant 22 

- satellite antenna coverage angle is set 

by beam data, not antenna data. Number on 
antenna record will be ignored 

52 Channels are out of order 22 

- channels must be listed in ascending order 

53 Protection ratio data out of sort 21 

54 Too many protection ratio sets 99 

- number of requested protection ratio sets 
exceeds maximum 

55 Circular antenna has unequal axes 22 

56 LAT. of PNT. > 70 Deg. rain attenu = 0 dB 20 

- the rain attenuation model is not valid 
within 20 degrees of pole. Rain attenuation 
for this point will be set at 0 dB 
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ERROR NUMBER 


ERROR MESSAGE 


ERROR LEVEL 


57 97 

58 Up/down data not present for requested calcs. 98 

A up or down calculation was requested and 
the up or down scenario cards are not present 

59 Delta-G zero or negative 98 

60 No satellite power type flag. 98 

- The satellite power flag was not set either 
as a default or in the service area 

61 Satellite power set to zero 98 

- Satellite transmitter power is specified 
as 0 Watts 

62 No FLT power flag 98 

- The FLT power flag was not set either as 
a default, or in the service area 

63 FLT power set to zero 98 

- FLT transmitter power is set to 0 Watts 

64 

65 No Earth Antenna specified 98 

- The Earth antenna key fields, both in the 
Scenario header and service area cards are blank 

66 No satellite antenna specified 98 

- Similar to Note 65 above 

67 
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F RROR NUMBER 


ERROR MESSAGE 


ERROR LEVEL 


68 dB value to large (small), possible problem 97 

- A dB value has a absolute value so large 
that an underflow or overflow 

problem may exist. 

69 No rain zone specified 98 

- The rain zone fields in both the point set 
header and the point itself are both blank 

70 No protection ratio specified 98 

- A needed protection ratio key field has 
been left blank 

71 Transmit antenna used as a receiver 98 

72 Receive antenna used as a transmitter 21 

73 Receive antenna has no noise temperature 97 

specified 

74 Receive antenna has no noise/fig. -merit flag 97 

75 Min. FLT antenna diameter must be > 0 
This field (cols 16-19 of RARC record 1 in 
Data. Parameters) must be > 0, even if antenna 
gain type 4 is not used. 

76 P2 Graphs phi-zero must be > 0 98 

77 Channel Bandwidth must be > 0 22 

78 Channel separation should be > 0 22 

79 Channel noise bandwidth should be > 0 98 


E-10 


ERROR NUMBER 


ERROR MESSAGE 


ERROR LEVEL 


80 Channel separation should be > 0 98 

81 Peak-to-peak deviation should be > 0 98 

82 Channel number exceeds no. of channels 20 

83 Percent-worst-month must be non-negative 98 

84 Read error in Requirement file 99 

85 Read error in Ellipse file 99 

86 Read error on reading a point override card. 99 

87 Single Vtm chnl incompatible with group flag 22 

- either turn group flag (col 75 scenario 
Record 3) to "N" or single victim channel 
(col 62-63 of same record) to zero 

88 No points selected from set. 98 

- No points of the point types requested 
in the point selection code exist in the 
point set 

89 Report option unspecified, set to "NO" 20 

90 Scenario field protected - cannot override 22 

- The installation has designated a scenario 
field (marked by astericks in the control 
override output reports) as protected from control 
overrides. 
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ERROR NUMBER 


ERROR MESSAGE 


ERROR LEVEL 


91 All interference calculations inhibited 97 

- The existence of optional Control Records 
9, 10 or 11 indicate that the user wants to 
calculate interference only into selected 
service areas, but none of the requested area 
names match service areas in scenario 

92 Max Phi/PhiO cannot be negative 98 

- Put 0 or positive number in col. 59-61 of 
Scenario Record 3 
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HOW TO ENTER A PROTECTION RATIO TEMPLATE «4ii<L . 


The template in Figure 2 has five segments, as noted in the caption. 
Now we shall find the necessary parameters for the segments. 

a Segment 1 

Upper limit 

The upper normalized freauency of this segment is -.982 
Offset 

The offset is the normalized frequency coordinate of some 
point on the segment whose value we know. The labeled end 
point is the obvious choice, ^.982 

Slope 

86 from the figure 
Segment value at offset 

We have chosen the end point as the offset point. At this 
point the value is -22 dB. 

a Segment 2 

Upper limit 
-.248 
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Offset 

We can choose either end point for the offset. Arbitrarily 
we choose the upper end point, -.248 


Slope 

Slope is equal to (aPR/a frequency) where a means difference 
{(22) - 0) / ( (—.982 ) - (-.248)) = 29.97 
Segment Value at Offset 

The value at the upper end point, chosen as offset, = 0. 

• Segment 3 a 

Upper limit 
.248 

Offset 

We choose .248 (because the slope is zero, we could use any 
number as an offset - the segment-value at-offset will 
always be zero) 

Slope. 

0 

Segment-va 1 ue-at-of f set 
0 

• Segment 4 

Upper limit 
.82 


Offset 

We choose .82 
Slope 

As in Segment 2, we calculate 29.97 
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Segment-val ue-at-of f set 
-22 


• Segment 5 

Upper limit 

As this last segment extends indefinitely the upper limit 
has no meaning, we leave it blank 

Offset 

We know the value at only one point, .92, so we choose it 
as an offset 

Slope 

-86 


Segment value at offset 
- 22.0 
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FIGURE 2 

SAMPLE PROTECTION RATIO TEMPLATE 


The following template is composed of 5 segments (each segment is 
labeled with a circled number). The two end segments 1 and 5, extend 
indefinitely. The segments are also designated. 
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APPENDIX G 

RELATION BETWEEN RARC PARAMETER, CHANNELIZATION, 
FAMILIES, AND INTERFERENCE CATEGORIES 


CHANNEL 

fty , % ci' s rev, 


The channelization data contains the following information: 

• Lowest Center Frequency. The center frequency of channel 1 

• Number of channels. Used only to determine whether the RARC 
parameters are violated 

e Channel Bandwidth. Also used only to determine the whether the 
RARC parameters are violated 

• Channel Separation. Used to determine the center frequency of 
all channels except channel 1 

• Channel Noise Bandwidth. Used only to determine carrier to 
noise ratio 

t Top Baseband Frequency and Peak-to-Peak Deviation. Used to 
determine Carson's Rule Bandwidth for protection ratio 
calcul ations. 
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Figure 3 gives a sample of a set of RARC parameters, channelization 
and a set of channel families. 

A violation of the RARC parameters would occur only if a channel in 
the family overlaps one of the two guard bands. Channel one does not overlap 
the guard band, but if the number of channels in the channelization is greater 
than 36, the upper channels will overlap the upper guard band and the user 
will be warned. The L, M, and H on each channel family illustrate the nominal 
frequency the user will get for each channel family by specifying the low, 
median, or high nominal frequency option. As mentioned above, this frequency 
is used for all gain and attenuation calculations. 

The interference categories between the four families are calculated 
using the channel numbers only (the effect of the bandwidth is taken into 
account during the calculation of protection ratio from the template (Section 
VIII. D above). 

We discuss some of the interference categories between the four 
families below, using the notation X » Y to designate channel family X 
interfering into channel family Y. 

• AA » AA, BB » BB, CC > CC, and DD » DD all co-channel 
(obviouslyl ) 

t AA » BB 

All channels receive lower adjacent interference 

• AA » CC 

Most channels in CC receive both next-upper-adjacent and 
next-lower-adjacent interference simultaneously. 

t AA » DD 

Here we have both co-channel, next-upper-adjacent and 
next-lower-adjacent interference categories simultaneously. 
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• BB » AA 


All channels are upper adjacent 

• BB > CC 

Lower adjacent 

Other family pairs are done in an analogous fashion. 
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